Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools / Telephone Tools Reference

Tool-Defined Functions /

MyVVAL

Called to handle validation operations.

pascal long MyVVAL (
                     TELHandle hTEL, 
                     short msg, 
                     long p1, 
                     long p2, 
                     long p3);

hTEL

A handle to a telephone record for the user's terminal.

msg

A constant that identifies the type of message being sent to the telephone tool. See "Validation Code Resource Messages," beginning on page 6-40 for a complete description of the available messages for a validation code resource.

p1

The first parameter for the specified message.

p2

The second parameter for the specified message.

p3

The third parameter for the specified message.

function result

A result code. See the description below for specific codes you can return.

DESCRIPTION

The MyVVAL function is the entry point to the validation code resource of a telephone tool. It should inspect the message specified by the msg parameter and respond accordingly. Currently, a validation code resource should accept these two messages:

enum {
   telValidateMsg          = 0,
   telDefaultMsg           = 1
};

The meaning of the parameters p1, p2, and p3 is dependent on the message type specified by the msg parameter. See the descriptions of the validation code resource messages beginning on page 6-40 for information about these parameters for each message.

Your MyVVAL function should return, as its function result, a result code indicating the outcome of the request. You can return an operating-system result code or a Telephone Manager result code. If your function receives any message other than the two listed above, it should return the code telNotSupported.